home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / signal.man < prev    next >
Encoding:
Text File  |  1989-01-03  |  2.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SIGNAL                C Library Procedures                 SIGNAL
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      signal - simplified software signal facilities
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<ssiiggnnaall..hh>>
  13.  
  14.      ((**ssiiggnnaall((ssiigg,, ffuunncc))))(())
  15.      iinntt ((**ffuunncc))(());;
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      _S_i_g_n_a_l is a simplified interface to the more general
  19.      _s_i_g_v_e_c(2) facility.  See the _s_i_g_v_e_c(_2) manual entry for com-
  20.      plete details on how signals are handled.
  21.  
  22.      If _f_u_n_c is SIG_DFL, the default action for signal _s_i_g is
  23.      reinstated.  If _f_u_n_c is SIG_IGN the signal is subsequently
  24.      ignored and pending instances of the signal are discarded.
  25.      Otherwise, when the signal occurs further occurrences of the
  26.      signal are automatically blocked and _f_u_n_c is called.
  27.  
  28.      A return from the function unblocks the handled signal and
  29.      continues the process at the point it was interrupted.
  30.      UUnnlliikkee pprreevviioouuss ssiiggnnaall ffaacciilliittiieess,, tthhee hhaannddlleerr _f_u_n_c rreemmaaiinnss
  31.      iinnssttaalllleedd aafftteerr aa ssiiggnnaall hhaass bbeeeenn ddeelliivveerreedd..
  32.  
  33.      If a caught signal occurs during certain system calls, caus-
  34.      ing the call to terminate prematurely, the call is automati-
  35.      cally restarted.  In particular this can occur during a _r_e_a_d
  36.      or _w_r_i_t_e(2) on a slow device (such as a terminal; but not a
  37.      file) and during a _w_a_i_t(2).
  38.  
  39.      The value of _s_i_g_n_a_l is the previous (or initial) value of
  40.      _f_u_n_c for the particular signal.
  41.  
  42.      After a _f_o_r_k(2) or _v_f_o_r_k(2) the child inherits all signals.
  43.      _E_x_e_c_v_e(2) resets all caught signals to the default action;
  44.      ignored signals remain ignored.
  45.  
  46. RREETTUURRNN VVAALLUUEE
  47.      The previous action is returned on a successful call.  Oth-
  48.      erwise, -1 is returned and _e_r_r_n_o is set to indicate the
  49.      error.
  50.  
  51. EERRRROORRSS
  52.      _S_i_g_n_a_l will fail and no action will take place if one of the
  53.      following occur:
  54.  
  55.      [EINVAL]       _S_i_g is not a valid signal number.
  56.  
  57.      [EINVAL]       An attempt is made to ignore or supply a
  58.                     handler for SIGKILL or SIGSTOP.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0               May 20, 1986                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SIGNAL                C Library Procedures                 SIGNAL
  71.  
  72.  
  73.  
  74.      [EINVAL]       An attempt is made to ignore SIGCONT (by
  75.                     default SIGCONT is ignored).
  76.  
  77. SSEEEE AALLSSOO
  78.      kill(1), ptrace(2), kill(2), sigvec(2), sigblock(2), sigset-
  79.      mask(2), sigpause(2), sigstack(2), setjmp(3), tty(4)
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0               May 20, 1986                          2
  130.  
  131.  
  132.  
  133.